SureTax Returns API

DELETE Tax Items

OVERVIEWREQUESTRESPONSETRY IT OUT

Overview

This API endpoint enables the deletion of tax items, providing the capability to remove specific tax items. Deletion operations are filtered based on externalReportingEntity and companyCode parameters, allowing targeted removal of tax items associated with specific entities and companies. It's worth noting that while this endpoint offers valuable functionality, its usage is optional and may not be mandatory for all scenarios.

OperationId: DELETE Tax Items

Authorization Method(s): OAuth

Verb: DELETE

End Point: /api/v1/Forms/TaxItems

Request Body

OVERVIEWEXAMPLE

Request Model

Display Name	Field Name	Field Type
External Reporting Entity	externalReportingEntity	string
Data	data	DeleteTaxItemRequest

DeleteTaxItemRequest

Display Name	Field Name	Field Type
Company Code	companyCode	string
Reporting Date From	reportingDateFrom	string
Reporting Date To	reportingDateTo	string

Example Request

{
  "externalReportingEntity": "string",
  "data": {
    "companyCode": "string",
    "reportingDateFrom": "string",
    "reportingDateTo": "string"
  }
}

Request Headers

Display String	Field Name	Field Type
X-request-id*	x-request-id	string

*Mandatory parameter

Response Codes

code	description
202	The API responds with this code to indicate that the data was sent successfully.
400	Bad Request - The server could not process the request due to invalid input or missing required parameters.
401	401 Unauthorized: The user's authentication is not valid.
500	Internal Server Error - An unexpected error occurred on the server while processing the request.

To execute a web service call for API Key Enabled APIs, Select an environment and enter the client number and validation api key corresponding to that environment.

Select Environment:End Point:

/api/v1/Forms/TaxItems

Add Request Headers:

{
  "externalReportingEntity": "string",
  "data": {
    "companyCode": "string",
    "reportingDateFrom": "string",
    "reportingDateTo": "string"
  }
}